home *** CD-ROM | disk | FTP | other *** search
/ CD Ware Multimedia 1995 May / cd Ware (Juegos) Epimundo.iso / WIN / UT_SYSTM / LETBOX.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1994-12-16  |  9.6 KB  |  280 lines
  1. Firefly Software Systems Corp.
  2. Box 5035
  3. Oregon City, OR 97045
  4.  
  5. Tech support 503-694-2221
  6. Sales 503-694-2282
  7.  
  8.  
  9. FAX 503-694-5867
  10. BBS 503-694-2220  ---- For latest updates
  11.  
  12. Compuserve 74774,1421,47
  13. Internet 74774.1421@Compuserve.com
  14.  
  15. On CIS 'GO FIREFLY'
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22. The registered version has a new feature where Letter Box can be
  23. set up to prevent duplicate programs from being run at the same time.
  24. This requires the PIF be marked with a special flag and a switch to
  25. be set in the LETTRBOX.INI file.
  26. This feature is especially intended to make life easier for 
  27. corporate support departments.
  28.  
  29.  
  30.  
  31. Screen Captures:
  32. Text captures can be made using the edit menu options.
  33. Or shift-printscreen.
  34.  
  35. Bitmaps of the Windowed session can be made with alt-printscreen or
  36. ctrl-printscreen.
  37.  
  38.  
  39. Mistakes in documentation:
  40. Page 5. Programmers interface. wParam = 178h, is not complete.
  41. The return is a memory handle, marked GMEM_DDESHARE and the return
  42. is in AX, the lowword of the DWORD return. You must GlobalFree
  43. the handle when you are done.
  44. The line which has 178h, should read:
  45. 178h = get entire screen.
  46. DX is in the hiword of the return and AX is in the lowword.
  47.  
  48.  
  49. The Programmers interface in the Pro version of letter box, now returns:
  50.  
  51. For 17B hex, DX:AX returns the status flags. 
  52. See statusfl.inc in the
  53. DDK or contact Firefly tech support for details.
  54. The status flags have 32 bits of bit flags, Windowed, in select mode,
  55. created, destroyed, etc.
  56. Windowed is the 3 bit (zero based).
  57.  
  58.  
  59. For 17C hex, DX:AX returns the pif file flags.
  60. See statusfl.inc in the DDK or contact Firefly tech support for details.
  61. The pif file flags have 19 bits of bit flags.
  62. Enable close, full screen on start, disable certain hot keys, etc.
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. If you get a message that you have mis-matched video components, run
  72. the program supplied with letter box: VFYGRB.EXE.
  73. This will tell you which components are wrong.
  74. The fix normally is to re-install the video display drivers.
  75.  
  76.  
  77.  
  78. Letter Box Pro now has a new enhancement similar to Winbatch, where
  79. the programmers interface can be accessed from WINRexx.
  80. Personal Rexx for Windows is a product of Quercus Systems,
  81. P.O. Box 2157, Saratoga, CA 95070. (408) 867-REXX.
  82. For details contact Quercus or Firefly.
  83.  
  84.  
  85. The solution to problems where starting a DOS session results in
  86. an immediate close down of the session, and the error or status
  87. message disappears before it can be seen, is to set the 'Close on exit'
  88. switch to off. This will cause the DOS session to remain beind
  89. as an inactive window, with the necessary message left on the screen.
  90. Also:
  91. If you have a DOS Icon or other program that closes down as soon
  92. as it is started, so fast that you can not even see the error message,
  93. try setting the PIF that runs it to "NO CLOSE ON EXIT". That will
  94. keep the Window open but the DOS (VM) will be inactive. Then you should
  95. be able to see the exit message.
  96.  
  97.  
  98.  
  99.  
  100. If your PATH statement in autoexec.bat does not have a drive letter
  101. associated with the Windows Directory strange things can happen
  102. to your Windows environment, such as "\windows", instead of "C:\windows".
  103. It is a big mistake to attempt to run windows with such a shortened path.
  104.  
  105.  
  106. If you want your settings (maximized, etc) saved on exit, you must
  107. set the "SAVE on exit" switch in the settings dialog box, or
  108. in the OEM Fonts dialog box.
  109. Windowed/Full screen is NOT saved by this method. This could be changed,
  110. but would require some programming work. Please advise if you need this.
  111.  
  112. Some users, new to Windows don't understand about a Windowed DOS session.
  113. The reality is that there is a Windows Application called Winoldap(our
  114. version: Letter Box), that runs ALL DOS sessions. When a DOS session is
  115. windowed, Winoldap is the Window that you are looking at. The DOS screen
  116. is mapped to memory NOT visible. While this is happening the DOS screen
  117. is rendered into the window by the Windows module known as "the grabber".
  118. Every 1/50 of a second or so, the grabber updates the Window.
  119. THIS MEANS that the DOS's window is NOT the dos application.
  120. 1. Characters typed at the keyboard go to the DOS application.
  121. 2. Special characters go to the WINDOW.
  122.  
  123. This also means that to close a windowed or full screen session, you
  124. must shut down or exit the DOS application. If command.com is running
  125. you must explicitly type "EXIT <enter>"
  126. The DOS application must be shut down in the normal manner it would
  127. require if Windows were not running.
  128.  
  129. If this is still not clear, then understand this. There are 2 modes
  130. involved here. If a windowed session has a menu or one of it's dialog
  131. windows open, then you are in the WINDOW mode, else you are in the
  132. normal mode. In normal mode all keys, (except for a few special keys)
  133. go to the DOS application.
  134. Window mode includes operations where: mark, select,copy, paste are 
  135. in progress. When in these operations modes, the window title will be
  136. appended to with a string identifying the mode.
  137.  
  138.  
  139.  
  140. Firefly Software Systems Corp.
  141. Box 5035
  142. Oregon City, OR 97045
  143.  
  144. 503-694-2221
  145.  
  146. FAX 503-694-5867
  147. BBS 503-694-2220  ---- For latest updates
  148.  
  149.  
  150. 9-8-94
  151.  
  152. This program project is named Letter Box.
  153.  
  154. A replacement for WINOA386.MOD from Firefly Software Systems Corp.
  155. (Winoa386.mod is the sub system that Windows uses to run DOS applications).
  156. Not to be confused with COMMAND.COM, which winoa386.mod 
  157. RUNS but does not replace.
  158.  
  159. INSTALLATION --------------
  160. There is no automatic setup/install program yet!!
  161.  
  162. Warning!!! in the case of BWCC.DLL, don't copy an older version
  163. over a new version already installed.
  164.  
  165. These files are normally found in the Windows\SYSTEM subdirectory. ---------
  166.  
  167. Rename Winoa386.mod to something else like *.ms
  168. copy wx.mod to Winoa386.mod.
  169. Copy WOLDAPDL.DLL to the same directory with Winoa386.mod
  170. Copy the dosfon.fon font to the same directory(not same file as dosapp.fon).
  171. Letter Box requires BWCC.DLL, install in the same directory.
  172. Copy VTSR___.ttf to the same directory (see note below).
  173.  
  174. -------------------------------------
  175.  
  176. The next files go in the WINDOWS directory
  177. Copy(do not rename) DOSAPP.INI to DOSAPPX.INI. (in windows subdirectory).
  178. Copy WX.HLP to Windows subdirectory.
  179.  
  180.  
  181. The True Type font VTSR needs to be added to the system. Start Windows.
  182. Start a DOS session, make it Windowed(Alt-Enter), then Alt-Space to 
  183. open the system menu. Select the Settings/Install menu item. Select the
  184. OK button to finish installing the VTSR font. To verify the VTSR font
  185. is installed, choose Font/TrueType from the system menu, 
  186. "TT Video Terminal Screen" should be one of the fonts displayed.
  187.  
  188.  
  189. That's all it takes for the install.
  190.  
  191.  
  192. Latest BWCC.DLL can be obtained from Borland Forum on Compuserve "BCPPDOS",
  193. lib #2, "From Borland".  Or from our BBS 503-694-2220. (about 50k file).
  194.  
  195.  
  196.  
  197. Pifeditor: see section below for method of using our pif editor or
  198. the original.
  199.  
  200. To verify that Letter Box is installed. Start a Windowed DOS session.
  201. (Alt+Enter, will make a fullscreen session windowed). Select the
  202. settings menu item, then the "About" menu item.
  203.  
  204.  
  205. Problems reported will be fixed, where feasible within minutes. Hours,
  206. days, years. As fast as possible.
  207.  
  208.  
  209.  
  210. FEATURES:
  211.  
  212. System.ini switches
  213.  
  214. [NonWindowsApps]
  215. WinoaLogErrors=1    ; turns on error logging.
  216.             ; 0 = off, 1 = on, 2 = on and notify w/messagebox
  217.  
  218. Special Features
  219. Better error handling
  220. Faster
  221. --------------
  222. Screen updates (more to come).
  223. Starting a second DOS session; much faster.
  224.  
  225. New help file.
  226.  
  227. The User Interface has been improved somewhat. Operations which take some
  228. time, more than a second have an hourglass/wait icon displayed.
  229.  
  230. The system/settings menu now has 2 items. This Session, and PIF Editor.
  231. Brings up the pif editor and the correct pif file
  232. for the present DOS session.
  233.  
  234. New feature: A full screen menu item with "fonts". Causes Windowed session
  235. to go full size using largest font that will fit 80x25 or 80x50 completely
  236. on the screen. Also a font info dialog box, displays info about current
  237. font in use.
  238.  
  239.  
  240. The Settings dialog box, has a help button for DOS sessions that
  241. have gone to sleep and won't wake up.
  242.  
  243. True Type Fixed Fonts in a Windowed DOS session!!!! The dialog box will
  244. allow any point size you want to enter manually.
  245.  
  246. If you use a "?" in the pif file in the optional parameters,
  247. Winoldap will put up a dialog box prompt asking you to fill in the blank.
  248. Our implementation supports a browse button, cancel, help and maybe
  249. a history list. Now allows changing the full-screen/windowed option.
  250. This feature is quite powerful.
  251.  
  252. An Extended DOSAPP.ini file is now being used. The file name is "DOSAPPx.ini"
  253. This extended file will allow new features, including a limit on the number
  254. of instances that can be started.
  255.  
  256. A CopyScreen to clipboard menu item.
  257.  
  258. Error logging for system administrators. Log is kept in WINOLDAP.LOG in
  259. the Windows directory.
  260.  
  261. More stack space
  262.  
  263. More reliable during startup. Starting 2 dos sessions back to back
  264. won't crash your system or make it unstable.
  265. More reliable during run time. Critical error messages will always display
  266. under worst case.
  267. Should be much better on a network.
  268.  
  269. If the grabber file (vga.3gr or whatever) can't be found, you will
  270. get a specific message with precise missing file name when you try
  271. to start a DOS session. Try it. Rename the vga.3gr in system.ini to
  272. vgaz.3gr.
  273.  
  274. Help buttons in all dialog boxes.
  275.  
  276. A  True Type Terminal Font by Ed Behl. VTSR____.TTF.(if not included,
  277. see below) These type faces are from Ed Behl's type company, in Florida.
  278. This VTSR is a True Type but has the PC-8 (OEM terminal) type faces with
  279. the high ascii characters and the low ascii ( less than ascii 32), also
  280. known as the "funny faces" see ->,